OpenEdge Application Server:<br />Administration Changing the Web service deployment directory

As described in Chapter 4, "Configuring a Web Services Adapter Installation," you might want to move the location of the sample WSA Web application that is installed with OpenEdge to avoid any dependency on the OpenEdge installation. You also might want to specify a separate Web service deployment directory for a given WSA instance for the same reason, especially if you continue to use the sample Web application in its initial OpenEdge installation location. Otherwise, if you upgrade or re-install OpenEdge and do not manually backup them up, you can lose your current deployed Web services during the upgrade.

You can change the deployment directory for all Web services deployed to a given WSA instance by modifying the Web application descriptor file (web.xml). For a description of this file, see the information on the WSA as a Web application in Chapter 5, " Managing the Web Services Adapter." This file is initially installed at the following OpenEdge installation location for the WSA sample Web application:

`OpenEdge-Install-Directory`/servlets/wsa/WEB-INF/web.xml

Open the web.xml that defines the WSA servlet instance for editing in a text editor.

Locate the following XML in the file by searching for "deploymentDir" within the servlet definition for your WSA instance:

`<servlet>` <servlet-name>`wsa1_servlet`</servlet-name> <display-name>Web Services Adapter servlet 1</display-name> <!-- Enter an optional description of the Web Services Adapater servlet and uncomment this element if supported by the JSE <description>Web Services Adpater servlet 1</description> --> . . . <!-- To change the deployment directory from the default, uncomment this parameter and set the value to the correct directory. <init-param> <param-name>`deploymentDir`</param-name> <param-value>`C:/work/deployment/`</param-value> </init-param> --> . . . `</servlet>`

  <servlet>  
    <servlet-name>wsa1_servlet</servlet-name> 
    <display-name>Web Services Adapter servlet 1</display-name> 
    <!-- Enter an optional description of the Web Services Adapater  
         servlet and uncomment this element if supported by the JSE  
    <description>Web Services Adpater servlet 1</description> 
    --> 
    . . . 
    <!-- To change the deployment directory from the default,  
         uncomment this parameter and set the value to the correct  
         directory. 
    <init-param> 
      <param-name>deploymentDir</param-name> 
      <param-value>C:/work/deployment/</param-value> 
    </init-param> 
    --> 
    . . . 
  </servlet>

Remove the XML comment tags around the <init-param> element and specify the new deployment directory as the <param-value> element value (C:/work/deployment/).

Save and close the file with the new information.

If you have any existing deployed Web services for this WSA instance, move the existing WSA instance directory to the new deployment directory. For example, if the WSA instance directory is wsa1, move the entire directory subtree to the new deployment directory as follows, using the appropriate operating system commands:


`OpenEdge-Install-Directory`/servlets/wsa/`wsa1/` C:/work/deployment/`wsa1/`

Restart the JSE or Web server.

You can now deploy and otherwise manage Web services for the WSA instance, wsa1.